IRIX Base Documentation 2002 November/SGI IRIX Base Documentation 2002 November.iso/usr/share/catman/a_man/cat1/share_inst.z/share_inst

Text File | 2002-10-03 | 12.0 KB | 265 lines

SSSSHHHHAAAARRRREEEE____IIIINNNNSSSSTTTT((((1111MMMM))))                                                  SSSSHHHHAAAARRRREEEE____IIIINNNNSSSSTTTT((((1111MMMM))))



NNNNAAAAMMMMEEEE
     share_inst, client_inst, clone_client - diskless software installation
     tools

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     sssshhhhaaaarrrreeee____iiiinnnnsssstttt ----rrrr _r_e_l_e_a_s_e [ ----dddd ]
     cccclllliiiieeeennnntttt____iiiinnnnsssstttt ----rrrr _r_e_l_e_a_s_e ----cccc _c_l_a_s_s ----hhhh _h_o_s_t [ ----dddd ]
     cccclllloooonnnneeee____cccclllliiiieeeennnntttt ----rrrr _r_e_l_e_a_s_e ----cccc _c_l_a_s_s ----ffff _h_o_s_t_f_i_l_e ----cccclllloooonnnneeee _c_l_o_n_e-_r_o_o_t

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     _S_h_a_r_e__i_n_s_t , _c_l_i_e_n_t__i_n_s_t , and _c_l_o_n_e__c_l_i_e_n_t are tools that install the
     system software for diskless workstations.

     _S_h_a_r_e__i_n_s_t installs the portion of the IRIX operating system that
     diskless workstations can share.  This shared software is known as the
     sssshhhhaaaarrrreeee ttttrrrreeeeeeee.... A share tree can contain only one IRIX rrrreeeelllleeeeaaaasssseeee;;;; a separate
     share tree must be installed for each additional IRIX release that
     clients require.

     _C_l_i_e_n_t__i_n_s_t installs the software that is used exclusively by an
     individual diskless client.  This software, known as the cccclllliiiieeeennnntttt ttttrrrreeeeeeee,,,,
     contains the non-shareable portions of an IRIX release, such as
     configuration files and other private files that pertain only to a
     particular client.

     _C_l_o_n_e__c_l_i_e_n_t allows you to install multiple client trees at once.  By
     feeding it a hostfile, one can install many trees with no interaction.
     Also, _c_l_o_n_e__r_o_o_t can be either a sssshhhhaaaarrrreeee ttttrrrreeeeeeee or a cccclllliiiieeeennnntttt ttttrrrreeeeeeee....

     For each IRIX release, _s_h_a_r_e__i_n_s_t needs a parameter file,
     /_v_a_r/_b_o_o_t/_s_h_a_r_e._d_a_t, to supply the necessary configuration information.
     _S_h_a_r_e._d_a_t is a template file: /var/boot contains a working copy of
     _s_h_a_r_e._d_a_t for each IRIX release that the diskless server supports.  The
     working copy of _s_h_a_r_e._d_a_t for a given share tree is assigned the name of
     the IRIX release that the share tree contains.

     Since _s_h_a_r_e._d_a_t is a shell script that is invoked from _s_h_a_r_e__i_n_s_t, it
     should always be executable.  When modifying the file, a good practice is
     to change only the strings within the double quotes.

     _s_h_a_r_e._d_a_t contains the following variables:

     DDDDIIIISSSSKKKKLLLLEEEESSSSSSSS       directory prefix for the share root, client root, and swap
                    root

     SSSSHHHHAAAARRRREEEE          directory name for share root

     SSSSEEEERRRRVVVVEEEERRRR____NNNNIIIISSSS     indicates whether NIS is used for name lookups during
                    installation.  This option will not work with non-SGI NIS
                    masters.  The bootparam information which gets set in the
                    SGI NIS master takes time to propagate back to the
                    diskless server.



                                                                        PPPPaaaaggggeeee 1111






SSSSHHHHAAAARRRREEEE____IIIINNNNSSSSTTTT((((1111MMMM))))                                                  SSSSHHHHAAAARRRREEEE____IIIINNNNSSSSTTTT((((1111MMMM))))



     The _c_l_i_e_n_t._d_a_t file performs that same function for _c_l_i_e_n_t__i_n_s_t as
     _s_h_a_r_e._d_a_t performs for _s_h_a_r_e__i_n_s_t. _C_l_i_e_n_t._d_a_t contains parameters that
     configure a specific class or workstation architecture.

     The _c_l_i_e_n_t._d_a_t file contains the following variables:

     CCCCLLLLRRRROOOOOOOOTTTT         directory name for client root

     SSSSWWWWAAAAPPPP           name of the directory where the swap file will be created.
                    The swap directory must be on the same server as client
                    root.

     SSSSWWWWAAAAPPPPSSSSIIIIZZZZEEEE       size of swap file.  The default is set to 20 MB.

     NNNNIIIISSSSDDDDOOOOMMMMAAAAIIIINNNN      NIS domain of client if the client's domain is different
                    than the server's

     CCCCPPPPUUUUAAAARRRRCCCCHHHH        type of CPU architecture on clients in this class.  If the
                    supporting sssshhhhaaaarrrreeee ttttrrrreeeeeeee is configured for this class of
                    clients exclusively, this variable may be set in
                    _s_h_a_r_e._d_a_t.

     CCCCPPPPUUUUBBBBOOOOAAAARRRRDDDD       type of cpu board on the clients in this class.  If the
                    supporting sssshhhhaaaarrrreeee ttttrrrreeeeeeee is configured for this class of
                    clients exclusively, this variable may be set in
                    _s_h_a_r_e._d_a_t.

     GGGGFFFFXXXXBBBBOOOOAAAARRRRDDDD       type of graphics board on the clients in this class.  If
                    the supporting sssshhhhaaaarrrreeee ttttrrrreeeeeeee is configured for this class of
                    clients exclusively, this variable may be set in
                    _s_h_a_r_e._d_a_t.

     MMMMAAAACCCCHHHH           type of machine tag assigned to this clients in this
                    class.  If the supporting sssshhhhaaaarrrreeee ttttrrrreeeeeeee is configured for
                    this class of clients exclusively, this variable may be
                    set in _s_h_a_r_e._d_a_t.

     VVVVIIIIDDDDEEEEOOOO          type of video option on clients in this class.  If the
                    supporting sssshhhhaaaarrrreeee ttttrrrreeeeeeee is configured for this class of
                    clients exclusively, this variable may be set in
                    _s_h_a_r_e._d_a_t.

     Both _s_h_a_r_e__i_n_s_t and _c_l_i_e_n_t__i_n_s_t are shell scripts that call _i_n_s_t(1M) to
     perform the software installation.  They also modify files, like
     /etc/fstab and /etc/hosts, in the resulting trees, so the diskless
     workstation can be brought up correctly.  When _s_h_a_r_e__i_n_s_t creates the
     sssshhhhaaaarrrreeee ttttrrrreeeeeeee,,,, it populates the tree with the shareable files.  By
     definition, files whose pathnames begin with /usr, /sbin, /lib, and
     /stand are shareable.  When _c_l_i_e_n_t__i_n_s_t creates the cccclllliiiieeeennnntttt ttttrrrreeeeeeee,,,, it makes
     a swap file and modifies client boot parameters.  It also exports
     necessary directories to the appropriate host.




                                                                        PPPPaaaaggggeeee 2222






SSSSHHHHAAAARRRREEEE____IIIINNNNSSSSTTTT((((1111MMMM))))                                                  SSSSHHHHAAAARRRREEEE____IIIINNNNSSSSTTTT((((1111MMMM))))



OOOOPPPPTTTTIIIIOOOONNNNSSSS
     ----rrrr _r_e_l_e_a_s_e
               Using release _r_e_l_e_a_s_e. The file _r_e_l_e_a_s_e._d_a_t should exist in the
               /var/boot directory.

     ----cccc _c_l_a_s_s  Using class _c_l_a_s_s. The file _c_l_a_s_s._d_a_t should exist in the
               /var/boot directory.

     ----hhhh _h_o_s_t   Indicates the client tree is created for workstation named
               _h_o_s_t. The _h_o_s_t must be a valid hostname, i.e. it should have
               already been assigned an IP address.  This parameter does not
               have any effect when creating the share tree.

     ----ffff _h_o_s_t_f_i_l_e
               A file containing a list of valid hostnames

     ----cccclllloooonnnneeee _c_l_o_n_e-_r_o_o_t
               Indicates that the cccclllliiiieeeennnntttt ttttrrrreeeeeeee is to be created by cloning an
               existing cccclllliiiieeeennnntttt ttttrrrreeeeeeee or sssshhhhaaaarrrreeee ttttrrrreeeeeeee _c_l_o_n_e-_r_o_o_t is the full
               pathname of the source client/share tree.

     ----dddd        To remove the diskless tree.  The default is to install the
               tree.

EEEEXXXXAAAAMMMMPPPPLLLLEEEE
     ////vvvvaaaarrrr////bbbbooooooootttt////sssshhhhaaaarrrreeee____iiiinnnnsssstttt ----rrrr 6666____5555

     will create a share tree for a specific release _6__5.  The
     /_v_a_r/_b_o_o_t/_6__5._d_a_t file should exist before you run the command.

     ////vvvvaaaarrrr////bbbbooooooootttt////cccclllliiiieeeennnntttt____iiiinnnnsssstttt ----rrrr 6666____5555 ----cccc RRRRAAAACCCCEEEERRRR ----hhhh ggggoooollllddddffffiiiinnnnggggeeeerrrr

     will create a client tree for class _R_A_C_E_R and machine _g_o_l_d_f_i_n_g_e_r.  The
     /_v_a_r/_b_o_o_t/_R_A_C_E_R._d_a_t file should exist before you run the command.

NNNNOOOOTTTTEEEE
     Please see the _D_i_s_k_l_e_s_s _S_y_s_t_e_m _A_d_m_i_n_i_s_t_r_a_t_i_o_n _G_u_i_d_e for more details.
     This man page was not intended to give enough information to perform a
     complete install.  The _N_F_S _r_e_l_e_a_s_e _n_o_t_e_s contain additional installation
     information not included in the guide.

FFFFIIIILLLLEEEESSSS
     /var/boot/share_inst          Share tree install script
     /var/boot/share_setup         Script to create share tree config files
     /var/boot/share.dat           Template for release.dat
     /var/boot/client_inst         Client tree install script
     /var/boot/client_setup        Script to create client tree config files
     /var/boot/client.dat          Template for class.dat
     /var/boot/clone_client        Tree cloning script
     /var/boot/verify              Script to check *.dat files





                                                                        PPPPaaaaggggeeee 3333






SSSSHHHHAAAARRRREEEE____IIIINNNNSSSSTTTT((((1111MMMM))))                                                  SSSSHHHHAAAARRRREEEE____IIIINNNNSSSSTTTT((((1111MMMM))))



SSSSEEEEEEEE AAAALLLLSSSSOOOO
     inst(1M), share_setup(1M), yp_bootparam(1M)





















































                                                                        PPPPaaaaggggeeee 4444